tencent cloud

Feedback

Rich Media Notification

Last updated: 2024-11-20 16:59:51

    Overview

    Rich media push allows you to push rich media contents such as image, audio, and video in addition to text, which can effectively increase the notification click rate. You can use this feature to push a wider variety of contents such as news, coupons, and event information, satisfying your personalized push needs.

    Application Scope

    Currently, Tencent Push Notification Service rich media push supports the following types of rich media contents:
    Android: image and audio
    iOS: image, audio, and video
    Note:
    The Tencent Push Notification Service channel for iOS supports rich media push by default. For the APNs channel, applications need to integrate with the notification service extension plugin.
    The supported types of rich media and use requirements for each push channel are as follows:
    Push Channel
    Supported Type
    Use Requirements
    Huawei
    Thumbnail
    Only HTTPS URLs are supported.
    Format requirements:
    PNG, JPG, and JPEG
    120 x 120 px. The image will be automatically resized if its width or height exceeds 120 px.
    Less than 200 KB.
    Mi
    Large image
    Only HTTPS URLs are supported.
    Format requirements:
    PNG, JPG, and JPEG
    Fixed at 876 x 324 px.
    Less than 1 MB.
    Note: to use the large image notification feature in the Mi channel, you need to first call the image upload API of Mi to upload the image file, get the image address pic_urlspecified by Mi, and enter it in the corresponding Tencent Push Notification Service push parameter xg_media_resources. For more information, see the large image upload API description in here.
    Tencent Push Notification Service
    Large image, thumbnail, and audio
    Android platform:
    Only HTTPS URLs are supported.
    Image format requirements:
    JPEG, JPG, and PNG .
    The height of a large image cannot exceed 324 px and the width is adaptive.
    The size of a thumbnail should be 120 x 120 px. If its height or width exceeds 120 px, it will be cropped into a square.
    Audio file format requirements: an audio file cannot exceed 5 MB.
    iOS platform: the requirements are the same as that of the APNs channel.
    APNs
    Thumbnail and audio/video
    Only HTTPS URLs are supported.
    Image format requirements:
    JPEG, PNG, and GIF formats.
    Less than 10 MB.
    Audio/Video file format requirements:
    Video encoding formats: MPEG, MPEG-2 Video, MPEG-4, and AVI
    Audio file extensions: AIFF, WAV, and CAF
    Audio encoding formats: Linear PCM, MA4 (IMA/ADPCM), alaw, and μLaw
    An audio/video file should be less than 5 MB.
    An audio file should be less than 30s long.
    Note: image and audio/video cannot be enabled at the same time.

    Operation Directions

    Console

    1. Log in to the Tencent Push Notification Service console. Go to Message Management > Task List.
    2. Click Create Push > Advanced Settings.
    
    
    3. Enable Notification Image or Notification Audio/Video, and enter the rich media message URL. The detailed configuration instructions are as follows:
    When you enable Notification Image: Android:
    Note:
    Thumbnail: The URL must be in HTTPS format. The thumbnail can be displayed in pushes delivered through the Tencent Push Notification Service and Huawei channels. Format requirements: PNG, JPG, or JPEG; 120 × 120 px; less than 200 KB
    Large image: The URL must be in HTTPS format. The large image can be displayed in pushes delivered through the Tencent Push Notification Service and Mi channels. Format requirements: PNG, JPG, or JPEG; 876 x 324 px; less than 1 MB.
    
    
    iOS:
    Note:
    After the image URL is entered, the image will be displayed in the notification. Format requirements:
    The file size cannot exceed 10 MB.
    The file must be in PNG, JPG, JPEG, or GIF format.
    The URL must be in HTTPS format.
    
    
    
    When you enable Notification Audio or Notification Audio/Video: Android:
    Note:
    After the audio URL is entered, notifications delivered through the Tencent Push Notification Service channel can contain audio.
    The audio file size cannot exceed 5 MB.
    The URL must be in HTTPS format.
    
    
    iOS:
    Note:
    After the audio/video URL is entered, notifications can contain audio or video and be played back through Apple's native component.
    The audio/video file size cannot exceed 5 MB.
    The file must be in MPEG, MPEG-2 Video, MPEG-4, or AVI format.
    The URL must be in HTTPS format.
    
    
    

    RESTful API

    To send a rich media message via an API call, you can set the following parameters in the Android or iOS message body in the Push API:
    Platform
    Parameter
    Notes
    Android
    Thumbnail: icon_res, icon_type
    Large image: xg_media_resources
    Audio: xg_media_audio_resources
    Thumbnails are supported only for the Tencent Push Notification Service and Huawei channels.
    Large images are supported only for the Tencent Push Notification Service and Mi channels.
    Audios are supported only for the Tencent Push Notification Service channel.
    iOS
    Image and audio/video: xg_media_resources
    Notification Image and Notification Audio/Video cannot be enabled at the same time.
    For more information, see the Required Parameters section in Push API.

    Below is a sample push on Android:

    {
    "audience_type": "token",
    "token_list": [
    "05da87c0ae******2dfa9e08d884aada5bb2"
    ],
    "message_type": "notify",
    "multi_pkg":true,
    "message": {
    "Title": "Push title",
    "content": "Push content",
    "xg_media_resources": "xxx1" , // Enter the URL of the rich media element, such as `https://www.xx.com/img/bd_logo1.png?qua=high`.
    "xg_media_audio_resources":"xxx", // Enter the URL of the audio, such as `https://sc1.111ttt.cn/2018/1/03/13/396131227447.mp3`.
    "android": {
    "icon_type": 1,
    "icon_res": "xxx", // Enter the URL of the thumbnail.
    "custom_content":"{\\"key\\":\\"value\\"}"
    }
    }
    }

    FAQs

    The Meizu, OPPO, and vivo channels do not support rich media. How do I deliver notifications to all devices?

    Notifications delivered through the Tencent Push Notification Service, Huawei, Mi, and FCM channels contain images, while those delivered through the Meizu, OPPO, and vivo channels are in plain text format without images by default.

    How can I include an image in a push message?

    Whether you call an API or use the console to deliver a message, you need to generate a URL for the image to include it in the message.

    What is the policy for delivering audios on Android?

    Audio pushes delivered through the Tencent Push Notification Service channel can display the audios normally, while those delivered through other channels will be in plain text format without audios by default.

    Can I enable both Notification Image and Notification Audio/Video for iOS?

    No. You can only enable either of them.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support